home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / miscellaneous / add-ons / fastimagefxmodules / fastifxmodules.readme < prev    next >
Text File  |  1996-09-07  |  20KB  |  399 lines
  1. HHsFastImageFXModules 6.2
  2. =========================
  3.  
  4. new in V6.x: Downscaled loading support; useful if you have big pictures to
  5.     load... no more out of memory problems (or slow virtual memory).
  6.     Simply load the pictures in downscaled form (25% size or 50% size);
  7.     also available as option for loading from ARexx scripts.
  8. new in V5.0: TrueColor animation saving support in HHsYUVSq animation format
  9.     ->create your own TrueColor animations for playback on CyberGraphX
  10.       with CyberTVPlayer or on EGS with EGSTVPlayer <-
  11.     Including ARexx scripts for automatic conversion of picture
  12.      directories or other animations into HHsYUVSq animation format
  13.     Inclusion of additional IFXAppWindow utility
  14.  
  15. -> you can order the FastIFXModules at a small add-on price if you also
  16.    order CyberShow (my universal viewer/slideshow program for all Amigas with
  17.    OS3.0; incl. CyberGraphX support...), EGSPhotoAlbum or EGS-TV Professional
  18.  
  19. The fast universal loader/saver modules can be used with ImageFX and
  20. ImageFX-EGS. They are shareware; without a keyfile which you get after
  21. registration, they will load and save all pictures or animations in greyscale,
  22. regardless if they are color or not, but the speed and format support is
  23. the same, so that you can try if they fit your needs.
  24.  
  25. Warning: I am aware that illegal/modified keyfiles of this module may exist.
  26. !Use of such keyfiles ("hhsloaderkey.library") is strictly prohibited and
  27. !can lead to undefined results and problems! For a program which you use
  28. !you should also be willing to pay the shareware fee. Only if enough users
  29. !register I will be able to do further improvements or create other graphic
  30. !applications. You can also help me by sending me illegal keyfiles of
  31. !this product which you find somewhere.
  32.  
  33. The loader module currently supports the following file formats:
  34.  
  35. * IFF-ILBM (all standard formats 1 to 8Bit, EHB, HAM6, HAM8, 24Bit)
  36. * PhotoCD (Base format 768x512 or 512x768 (portrait); linear 24Bit colors)
  37. * PPM/PGM/PBM (P1&P4 b&w, P5 grey, P6 color)
  38. * QRT (also known as dump format by PD raytracers as POV-Ray)
  39. * Targa (RLE compr.&uncompr. 1/8/15/16/24/32Bit;incl. interleaved)
  40. * PCX (compr.&uncompr. EGA1-4Bit, VGA 8Bit grey/Colormap and 24Bit)
  41. * MacPaint (b&w compressed 1Bit format; datafork only)
  42. * BMP (uncompr. 24Bit RGB,1Bit,4Bit or 8Bit Colormap; RLE compressed 8Bit,1Bit)
  43. * TIF (packbit-compr.&uncompr. 24Bit,1-8Bit grey/Color Motorola&Intel formats)
  44. * EGS7.x window iconification file format
  45. * DEEP (compr.&uncompr. 24Bit and 32Bit)
  46. * RGB formats (RGB8, RGBN, RGB5)
  47. * ACBM formats (1 to 8Bit, incl. HAM6/HAM8)
  48. * FBM formats (8Bit grey/color and 24Bit)
  49. * IFF-PBM (DPII) format
  50. * Sun raster (1Bit, 8Bit grey/color and 24Bit uncompressed)
  51. * YUV (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  52. * VLAB raw (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  53. * HHsYUVSq sequence format (sequential or random access; only first frame)
  54. * HHsXRL formats (1-8Bit ColorMap incl. HAM6/8, 8Bit grey, 24Bit RGB compressed)
  55. * binary-EPS bitmaps (RGB and CMYK; this function is experimental)
  56. * TBCPlus frames/fields
  57.  
  58. * Picture DataTypes (many formats are available as DataTypes for OS3.x users)
  59. * Animation DataTypes (many animation formats are available as DataTypes for
  60.   OS3.1 users; currently only the first frame can be loaded with Animation DataTypes)
  61.  
  62. The saver module currently supports the following file formats:
  63.  
  64. * HHsYUVSq animation format (upto size 360x310); create new animations (by
  65.   specifying a new file) or append frames to an animation (select old file).
  66.   Please note: Image width must be in the range 80 to 360 (even size will
  67.   be generated); Image height must be in the range 64 to 310. To append
  68.   frames to an animation, the image size in ImageFX must match the frame
  69.   size of the file you want to append to. Otherwise (or if you specify
  70.   not a HHsYUVSq anim file) the error "Unrecognized file format" occurs.
  71. * QRT (also known as dump format by PD raytracers as POV-Ray)
  72. * Targa (RLE compr.&uncompr. 24Bit, 8Bit grey, 8Bit color map, 1Bit color map)
  73. * HHsXRL formats (1-8Bit ColorMap incl. HAM6/8, 8Bit grey, 24Bit RGB compressed)
  74.   with optional lossy reduction for TrueColor or greyscale pictures; this new
  75.   file format series has surprisingly good (lossless) compression of raytraced
  76.   24Bit pictures or undithered color mapped pictures with 2 to 256 colors;
  77.   also very usable with ClipArt...; this format can be saved in color
  78.   even in the demo version (to check the good compression), but loading
  79.   will be in greyscales in the demo as well.
  80.  
  81. To install the loader/saver modules, just use the included install script.
  82. This will copy the files named "-HHsFastImageFXLoader-" and
  83. "-HHsFastImageFXScaler-" to your ImageFX:modules/loaders directory and
  84. "-HHsFastImageFXSaver-" to your ImageFX:modules/savers directory. In
  85. addition your keyfile will be installed to LIBS: if you start the install
  86. script from your original full version disk.
  87.  
  88. If you also want to use the ARexx scripts for easy animation creation
  89. or the IFXAppWindow tool, you have to install them manually by dragging
  90. them whereever you like them to be.
  91.  
  92. The modules should work with standard ImageFX (1.5x, 1.6x, 2.x, ...)
  93. as well as with ImageFX-EGS. I have tried them with both ImageFX-EGS 1.6
  94. and the new ImageFX 2.1 (thanks to NOVA design). The speed advantages
  95. below have been measured with the new ImageFX 2.1. Compared with
  96. ImageFX-EGS 1.6 some of them were even slightly higher (in addition
  97. ImageFX-EGS comes with fewer standard loader modules).
  98.  
  99. The file format is automatically detected for loading except for the DataType
  100. formats. If you want to load a picture with a DataType, you have to use the
  101. "Load As" function from ImageFX and select "-HHsFastImageFXLoader-" manually
  102. as loader module. The name of the loader module begins with a "-" so that it
  103. appears first in the list of loader modules and thus is used before all
  104. other loader modules.
  105.  
  106. Downscaled loading: To load an image in downscaled form you have to
  107. explicitly select the special loader variants with "50%_size" or "25%_size"
  108. by using Buffer/LoadAs in the loader list. Thoose downscaled loading
  109. functions do currently not support Datatypes if selected manually.
  110. For most of the supported file formats, the picture can be loaded line by
  111. line and loading in downscaled form will thus need much less memory.
  112. Finally a way to load even biggest pictures without slow virtual memory...
  113.  
  114. ARexx support: If you want to load pictures in downscaled form from
  115. ARexx scripts, you can select even more downscaling factors. To use
  116. this you should NOT specify the xx%_size loaders but instead use
  117. LOADBUFFERAS -HHsFastImageFXLoader- ...picturename... Scale #
  118. where you replace # by a single digit from 1 to 9, which will then
  119. be used as a downscaling factor (e.g. 2 for 50%, 4 for 25%). In this
  120. case also Datatype pictures can be loaded in downscaled form.
  121.  
  122. The typical speed advantage factors on my configuration (see below) are:
  123.  
  124. DataTypes: depending on DataType, but usually loading will be significantly
  125.            faster with my DataType support (compared to IFX 2.1 DataType support),
  126.            e.g. about 1.5 for ZGIF DataType or REKO DataType...
  127. IFF-ILBM: upto 4.75 (e.g. IFF 8Bit)
  128. PPM/PBM: upto 7.2 (P6)
  129. QRT: upto 4.4
  130. Targa: upto 8.7 (uncompr.)
  131. PCX: upto 11.2 (planar 4Bit)
  132. BMP: upto 4.6 (24Bit)
  133. TIF: upto 8.5 (packbit compr. 4Bit)
  134. RGB: upto 3.7 (RGB8)
  135. YUV: upto 5.6 (YUV1/4)
  136. IFF-PBM: upto 1.3
  137. SunRaster: upto 4.6 (grey)
  138. MacPaint: upto 1.5
  139. GIF: upto 2.1 (HHsFastIFXModules DataType loading with ZGIF-DataType compared with
  140.                IFX-GIF loader)
  141. PhotoCD: upto 2.0 (compared with PD-PCD loader in base size; in addition my loader
  142.      usually rotates portrait pictures automatically to correct orientation)
  143.  
  144. (only loading times compared, not displaying; my configuration: Amiga 3000;
  145.  68030/25MHz; loading from Quantum harddrive; PhotoCD loading from NEC2x)
  146.  
  147. The loader includes many formats, which the original loaders (I compared with
  148. ImageFX-EGS 1.61) do not support: PhotoCD, IFF-DEEP, IFF-ACBM, FBM, Sun raster,
  149. VLab raw, DataTypes, RGB5, PBM4, TGA1, YUV grey, PCX grey, BMP compressed, EGS icons,
  150. MacPaint (Datafork). Many of them are not supported by ImageFX 2.1 as well.
  151.  
  152. It also loads many formats, which are loaded with wrong colors (or other bugs)
  153. in some original loaders, e.g IFF-ILBM-EHB, BMP1, PBM1, TIF1 grey, TGA grey.
  154. The original PCX loader also had massive problems with loading VGA
  155. pictures from CD-ROMs under the OS3.1 CD-file system. Although this is a bug in
  156. the file system, I could work around this so that my loader should work with
  157. CD-ROMs under the OS3.1 filesystem. Please note that some third party CD-ROM-
  158. file systems can cause massive problems as well, so I recommend to use the
  159. original Commodore OS3.1 filesystem.
  160.  
  161. The saver module can be used as normal (QRT and HHsYUVSqAnimation only for true
  162. color/greyscale buffers; Targa and HHsXRL also usable for rendered images from
  163. 2 to 256 colors). The individual formats and variants are listed at the
  164. beginning of the list of savers in the SaveAs window. The typical speed
  165. advantage for the fast saver module:
  166.  
  167. QRT: upto 3.5
  168. Targa: upto 3.8 (compressed)
  169.  
  170. Beside the speed advantage, the general compression is also better
  171. (compared to ImageFX-EGS 1.61). Targa compression is sometimes 25% better
  172. with my saver than with the original. The Targa saver also supports
  173. the true greyscale format for greyscale pictures and allows compression
  174. of rendered images as well. Rendered 1Bit images will be saved in 1Bit
  175. Targa format. For good compression of e.g. raytracing pictures I recommend
  176. my own file formats "HHsXRL", usable from 1Bit to 24Bit. This format is
  177. also supported by my universal image viewer "CyberShow".
  178.  
  179. The HHsYUVSqAnimation saver can be used to create new animation files
  180. (if you specify a new file) or to append the current picture to an
  181. existing HHsYUVSq animation file which has the same frame size (if
  182. you specify an old HHsYUVSq animation file). The reccomended file
  183. extension for HHsYUVSq animation files is ".seq". To playback the
  184. animations you can use: a) CyberTVPlayer
  185.                 for playback in TrueColor with CyberGraphX
  186.                 or for playback on all Amigas with OS3.x
  187.             b) EGSTVPlayer
  188.                 for playback in TrueColor etc. with EGS
  189. Both CyberTVPlayer and EGSTVPlayer are freeware and should be available
  190. e.g. on Aminet in gfx/board.
  191.  
  192. For easy creation of HHsYUVSq animations two ARexx scripts are included:
  193.   a) MakeAnim.rx will ask for a source directory and a destination file.
  194.      It will then load all pictures in the source directory (in alphabetical
  195.      order) and create/append them into the HHsYUVSq animation. If neccessary,
  196.      downscaling will be applied. Please note that all pictures should have
  197.      the same size!
  198.   b) ConvertAnim.rx will ask for a source animation and a destination file.
  199.      The source animation can be in any animation format which ImageFX
  200.      supports. All frames will be loaded and then saved/appended into the
  201.      HHsYUVSq animation file (downscaled if neccessary).
  202.  
  203. The fast loading/saving functions have all been written by me in assembler and
  204. optimized for fastest speed. I did this for my famous shareware programs
  205. *** CyberShow *** (universal viewer for all Amigas and esp. for Cybergraphics
  206. users), *** EGSPhotoAlbum Professional *** (picture management and presentation
  207. software for EGS) and *** EGS-TV Professional *** (sequence/animation editing,
  208. framegrabber (VLab/IV24) and Blue Screen Keying software for EGS).
  209. When new formats are implemented for my other programs (or the speed is improved
  210. further), I will usually also update the modules, which registered user can then
  211. use due to the keyfile concept.
  212.  
  213. Please note: The HHsFastImageFXScaler module does not contain any loading
  214. function itself. Instead it invokes general loading with the Scale #
  215. parameter. This only works if the HHsFastImageFXLoader (or another
  216. loader which supports this) is installed as well.
  217.  
  218. Registration
  219. ============
  220.  
  221. You can register for the modules at the small add-on price of only 8US$ or
  222. 10DM if you order them together with one of my other shareware programs,
  223. e.g. CyberShow, the universal viewer and slideshow program for all Amigas
  224. with at least OS3.0 (loading the same formats as the FastIFXModules and
  225. additionally JPeg; incl. CyberGraphX support for TrueColor displaying...)
  226. or EGSPhotoAlbum or EGS-TV. Please use the registration forms of thoose
  227. programs and specify your add-on module order there and include the extra
  228. amount.
  229.  
  230. Otherwise you should use the included registration form to register:
  231.  
  232. If you only want to register for the modules, the registration fee is
  233. 18US$ outside europe or 20DM in europe. You will also get the latest demo
  234. versions of my other programs. Additional modules (e.g. UniversalGIO for
  235. Photogenics or XiPaintModule for XiPaint) can be ordered at the lower
  236. add-on price.
  237.  
  238. If you are already a registered user of one of my programs and now want to
  239. register for the modules, the registration fee is 13US$ outside europe or
  240. 15DM (in europe). Additional modules (e.g. UniversalGIO for Photogenics or
  241. XiPaintModule for XiPaint) can be ordered at the lower add-on price.
  242.  
  243. (Special note for users in germany only: Wenn Sie schon registrierter Benutzer
  244.  eines meiner Shareware-Programme sind und sich Ihre Anschrift nicht
  245.  geändert hat, können Sie die Module direkt per Überweisung bestellen.
  246.  Als Verwendungszweck geben Sie bitte "FastIFX für ...." an, wobei Sie
  247.  das Programm was Sie schon haben und die Registriernummer angeben.
  248.  Zusätzlich möglichst auch noch Name/Anschrift; die Bankverbindung:
  249.  Konto-Nr. 5740147 BLZ 310 500 00 Stadtspark. Mönchengladbach)
  250.  (No bank transfers from outside germany!)
  251.  
  252. Send your filled in registration form together with cheque, international
  253. postal money order or banknotes to:
  254.  
  255.     Helmut Hoffmann
  256.     Rubensstrasse 4
  257.     D-41063 Moenchengladbach
  258.     Germany
  259.  
  260. Special Thanks
  261. ==============
  262.  
  263. My special thanks go to Mr. Kermit Woodall, Mr. Thomas Krehbiel and
  264. NOVA design for their kind support
  265. and to all registered HHsFastIFXModule users (located currently in 18
  266. countries all over the world...).
  267.  
  268. Disclaimer
  269. ----------
  270.  
  271. This software (program and documentation) is provided "as is" and
  272. comes with no warranty, either expressed or implied.
  273. The author is in no way responsible for any damage or loss that may
  274. occur due to direct or indirect usage of this software. You use
  275. this software entirely at your own risk.
  276.  
  277. Copyright and Distribution
  278. --------------------------
  279.  
  280. HHsFastImageFXModule (modules and documentation) is copyright by
  281.  
  282.     Helmut Hoffmann
  283.     Rubensstrasse 4
  284.     D-41063 Moenchengladbach
  285.     Germany
  286.  
  287. The demo version may be freely distributed and used as
  288. long as the following conditions are met:
  289.  
  290. 1) All files have to be kept together
  291.  
  292. 2) No file may be modified or crunched/packed.
  293.  
  294.    The only official way to distribute the demo packed is the
  295.    original fastifxmodules.lha archive.
  296.    The modules may not be disassembled or analysed. The limitations
  297.    integrated in the demo version may under no circumstance be removed
  298.    or bypassed.
  299.  
  300. 3) Distributors may only charge for the duplication process (including media)
  301.    and not for the software. Theese charges may not exceed the following
  302.    limits: a) Demo on a PD-disk: 7$ (US-dollar) including
  303.               postage&packing (in Germany: 10DM)
  304.        b) Demo on a PD-CD-ROM: 40$ (US-dollar) including
  305.               postage&packing (in Germany: 60DM)
  306.        c) Demo on a BBS/Mailbox/ftp-site or other electronically
  307.               callable system: Maximum charge 3$ (US-dollar) (in Germany: 5DM)
  308.               for downloading
  309.    Anyway, it must be made explictly clear to the buyer, that he does not
  310.    pay for the modules (demo) itself but only for the duplication service.
  311.  
  312. 4) It is not allowed to distribute this demo with any commercial product
  313.    without a written permission by me. One exception is the distribution of
  314.    the demo version with products not exceeding the above price limits (e.g.
  315.    a cover-disk magazine for 7$ or less).
  316.  
  317.    The following companies have my explicit permission to distribute the
  318.    demo with their products: NOVA Design, Ingenieurbüro Helfrich, MacroSystem.
  319.  
  320. 5) The registered version may not be redistributed. It may only run on one
  321.    machine per registration. It is allowed to make a backup copy of the
  322.    original disk.
  323.  
  324. Version history
  325. ---------------
  326.  
  327. V1.0 (17th feb. 95): Support for IFF-ILBM,PPM,QRT,Targa,PCX,BMP,TIF,EGS7.x,
  328.             DEEP,RGB,YUV,VLab,HHsYUVSq,DataTypes (picture&animation)
  329.  
  330. V2.0 (25th feb. 95): Added support for FBM (24Bit,8Bit),IFF-ACBM,IFF-PBM(DPII),
  331.             Sun raster (1Bit, 8Bit, 24Bit uncompressed),PBM-P1,
  332.             BMP 4Bit and interleaved Targa formats
  333.              Slight acceleration of some loading functions (esp. ILBM)
  334.              Improved DataType handling
  335.  
  336. V2.5 (1st march 95): Added support for MacPaint (1Bit compressed; datafork only),
  337.             PBM-P4, PCX uncompressed and EGA-grey, Targa 1Bit,
  338.             TIF packbit compressed and grey 1-4Bit
  339.              Many enhancements on various formats for more compatibility
  340.  
  341. V3.0 (14th march 95): Introduction of the fast saver module to supplement the
  342.             fast loader module (QRT, Targa 1Bit/8Bit/24Bit, HHsXRL)
  343.               Added loader support for HHsXRL (1Bit-8Bit, HAM, 24Bit)
  344.               Acceleration of some planar loaders (e.g. ILBM, DataTypes)
  345.               Improved HAM6 loading quality
  346.               Correction of Targa 1Bit loading for compressed pictures
  347.  
  348. V3.1 (07th april 95): Acceleration of RGB8 and RGB5 loader function
  349.  
  350. V4.0 (30th april 95): Added support for PhotoCD (Base size; incl. portrait orientation)
  351.  
  352. V4.1 (09th may 95): Removed inconsistency in DataType-HAM8 handling for more compatibility
  353.             Filtering out of PCD overview files
  354.  
  355. V4.2 (07th july 95): Correction of Sun raster 24Bit loading (wrong colors and
  356.             problems with odd sized images)
  357.              Updated documentation to reflect speed advantage compared
  358.             to ImageFX 2.1 instead of ImageFX-EGS 1.6
  359.  
  360. V4.3 (12th july 95): Changed IFF-ILBM loading to not automatically load brushes
  361.             containing a mask (you can still load them as pictures
  362.             with my module by using the LoadAs function).
  363.             This was neccessary as otherwise brushes could not be
  364.             loaded together with their mask if the FastIFXModules
  365.             were installed (as there is no Brush-LoadAs function).
  366.  
  367. V4.4 (21st july 95): Support for RLE compressed 8Bit and 1Bit BMP files
  368.              Bug fix for loading function which could lead to crashes if
  369.             certain non-picture files where detected as a picture
  370. V4.5 (5th aug. 95): Changed TIF loader for better compatibility with certain pics
  371.             Extended Targa loader by 15Bit and 16Bit HiColor loading
  372. V4.6 (29th aug. 95): Support for new file formats: binary-EPS bitmaps RGB,CMYK
  373.             and TBCPlus frames
  374.              Correction of bug in datatype.library usage (which could
  375.             lead to a crash under OS2.x when no datatype.library was
  376.             present and LoadAs was used)
  377. V4.7 (9th oct. 95): Extended TIF loader to support "Intel" byte order files
  378.             and more variants
  379.  
  380. V5.0 (11th dec. 95): Extended saver module by HHsYUVSq animation saver function;
  381.             included ARexx scripts to automatically create such
  382.             animations from multiple pictures or from other anims.
  383.             Use CyberTVPlayer or EGSTVPlayer to play such animations.
  384.             Extended IFF loader to accept 0-sized chunks
  385.             Included bonus program "IFXAppWindow"
  386.  
  387. V6.0 (12th feb. 96): Support for downscaled loading: Special loader support
  388.             module "-HHsFastImageFXScaler-" offers 50% and 25% size
  389.             loading for selection in the loader list.
  390.             With ARexx parameter "Scale" you can select
  391.             any downscaling factor from 1 to 9 directly for the
  392.             FastImageFXLoader.
  393.             Useful to load "too big" pictures without much memory
  394.             or extremly fast...
  395.             Extended IFF loader to accept unusual sized color maps
  396. V6.1 (24th march 96): Changed PCX loading for more compatibility
  397. V6.2 (29th april 96): Extended PCX loading for even more compatibility
  398.  
  399.